COMMENT ⊗   VALID 00006 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	TELNET.MRC[UP,DOC] 6/26/78
C00004 00003	KEYBOARD CONTROL
C00009 00004	SOCKETS
C00012 00005	COMMANDS
C00017 00006	DATAMEDIA SIMULATION
C00019 ENDMK
C⊗;
TELNET.MRC[UP,DOC] 6/26/78

     The monitor commands to access TELNET are TELNET, TN, and OTN.
TELNET and TN are used to access the new TELNET protocol, which is the
official standard today.  The OTN command is used to access the
archaic and obsolete old TELNET protocol.  The syntax is:

     .TELNET socket,host

     TELNET prompts for an argument if one isn't given.  A "?" typed
in the command line prints out a short help message.

     The socket field is optional and must be a number followed by a
comma or atsign if present.  The host field is either a host name or a
number.  Numbers are octal unless followed by a decimal point or if an
8 or 9 occurs in the number, in which case it is assumed decimal.

     The host name/number is the ARPAnet site you wish to connect to.
A list of host name/number correspondences may be found in the file
TELNET.MRC[UP,DOC].  Host numbers, for the adventuresome, are
described fully in IMPSER.DOC[S,SYS].

     Sockets are explained more fully later on; but you probably can
ignore it unless you're a network hacker.

     Datamedia simulator TELNET is invoked by the DTN command.  Read
later on under Datamedia simulation.
KEYBOARD CONTROL

     This page does not apply to Datamedia simulator TELNET.

     TELNET has two modes--display and transparent.  Display mode is
legal for all terminals and is the default mode for all displays.
Transparent mode is only legal for DM's and non-displays and is the
default mode for non-displays.

     In display mode, character set conversion between Stanford ASCII
and standard ASCII is done.  In addition, the <CONTROL> bucky bit maps
the character down to its ASCII control; hence αC sends 003 or ↑C.  In
addition, the <META> bucky bit is the command escape and the <CONTROL>
bucky bit in conjunction with <META> is the command complement escape.
In other words, βE does the E command and αβE does the E complement
command.  Display mode is the only legal mode for DD's and III's.

     In transparent mode, no character set conversion is done.  All
ASCII characters (including ↑C) are read and transmitted as is, with
the exception of ↑↑ (control-uparrow, octal 036) which is the command
escape.  ↑↑ repeated sends ↑↑ to the foreign host (similar to TIP
doubling of @'s).  ↑↑ followed by - is the command complement escape.
In other words, ↑↑E does the E command and ↑↑-E does the E complement
command.  Transparent mode is the only mode which works well on
non-displays since it is the only mode where the full ASCII character
set can be sent.

     Transparent mode is occasionally useful for DM users if they wish
to use a foreign host's DM service.  For example, if you want to use
TVEDIT on a Tenex you want to be in transparent mode (after telling
the Tenex you're a DM).  In transparent mode the <EDIT> and [NULL]
keys are passed to the foreign host just as they are with no
interference from SAIL's terminal service.  On Datamedias, the escape
character is <EDIT>[NULL] instead of ↑↑.  Hence, <EDIT>[NULL] Q gets
you out of TELNET, and <EDIT>[NULL] - D closes an input file.

     Transparent mode is also useful for simulating the behavior you
get when you use a TIP.  In other words, your input gets passed to the
remote host the way you expect it to without SAIL randomly trapping
certain characters.  Of course, the escape character is trapped, but
it can be changed to any character desired with the X command, so ↑↑X@
makes things even more like what a TIP does.

     The proper way to flush a connection from TELNET is with the Q or
C commands (their complements are the same).  This gracefully closes
the network connection and in the case of the C command prompts for
another host to connect to.  In transparent mode this is either ↑↑C or
↑↑Q.  CALLing out of TELNET is never a good way to flush a connection
and of course can't be done in transparent mode since ↑C is an
ordinary character.

     Commands are never echoed, although their effects may cause
terminal output.
SOCKETS

     Unless you're a network hacker, you probably want to ignore this
page entirely.

     The socket number specifies which service at that ARPAnet site to
connect to.  For the TELNET and TN commands, the socket field defaults
to socket 27, and for the OTN command the socket defaults to 1.  New
TELNET servers listen to socket 27 and (in general) old TELNET servers
listen to socket 1.  Server socket numbers are always odd.

     More accurately, if the socket number is 27, TELNET uses the new
TELNET protocol, and proceeds to negotiate remote echo with the
foreign host.  If any other socket number is used, TELNET assumes the
old TELNET protocol.  However, if the foreign host starts talking new
protocol TELNET will happily go into new protocol mode; and TELNET
will not do any protocol negotiations in old mode unless either the
user gives a command which forces negotiations, or if the foreign host
starts negotiating (old or new) protocol.

     This means that TELNET will do the most intelligent thing in the
normal case of talking to socket 27; setting remote echo and flushing
go-ahead signals.  For other sockets, it will not talk protocol on its
own since it can't be sure if it's even talking to a protocol-talking
server; but if forced to it will talk old protocol.  This wins with
talking to FTP servers, a common use of TELNETting to a non-TELNET
server.  Also, it will accept either protocol in this state, and if
the server starts talking new protocol TELNET will go into new
protocol mode as well; which wins with new protocol servers on
non-standard sockets.
COMMANDS

Note: α means CONTROL, β means META, ⊗ means either META or CONTROL-META
Filespecs may be aborted with altmode.  There is no filename or extension
defaulting and the PPN defaults to the ALIAS PPN in the usual way.

β@	Disable debug mode.  This is the normal state.

αβ@	Enter debug mode.  Currently this reports the TELNET protocol
	negotiations between user and server.

αβALT	Enter DDT if one is present.  CPOPJ$G returns to TELNET.

⊗A	Send an ATTN to the foreign host.  This usually means something
	like "return to monitor".

⊗B	Send a BREAK to the foreign host.  This is distinct from ATTN; it
	appears to be something the Multics guys wanted and never used.

⊗C	Close connection and ask for a new host name to connect to.  This
	also exits transparent mode

βD	Open output file.  Everything sent from the foreign host goes in
	the file.  Asks for a filespec.

αβD	Close the output file.  ⊗Q implies this as well.

βE	Local echoing mode.  Forces the foreign host to stop echoing.

αβE	Remote echo mode.  Requests the foreign host to echo user typein.
	If the foreign host refuses to echo, the echo state is restored
	to local echoing.

βF	Open append file.  Everything sent from the foreign host goes in
	the file after the previous contents of the file.  If there was
	a file previously opened with βD, it will append to that,
	otherwise it will ask for a file name.

αβF	Same as βF, but always ask for a file name.

βI	Open input file.  Everything in the file is sent to the foreign
	host.  Asks for a filespec.

αβI	Close input file.  ⊗Q implies this as well.

βJ	Echo mode.  Turns on local echoing without consulting the foreign
	host.  See βE.

αβJ	No echo mode.  Turns off local echoing without consulting the
	foreign host.  See αβE.

⊗K	Send protocol command to kill the remote job.  This command is not
	guaranteed to work since many hosts do not implement the network
	logout protocol.

βL	Enter line mode.  This gives you the line editor on input.  This is
	the default for displays unless TELNETing to an ITS system.  The
	line editor is always echoed locally, but in remote or no echo mode
	the line editor will vanish after activation.

αβL	Enter character mode.  Transmission is character-at-a-time.  This
	is the default on printing consoles and when TELNETing to an ITS
	system.

⊗Q	Quit.  Close network connection and exit.

βR	Same as βI, but reads the file character-at-a-time instead of buffer-
	at-a-time.  This is less efficient, but also results in much less
	messy output, as the characters will be sent synchronously.  Asks for
	a filespec.

αβR	Same as αβI.

βT	Enter transparent mode.  Character set conversion and local terminal
	handling are disabled.

αβT	Non-transparent mode.  Character set conversion and local terminal
	handling are enabled.

⊗W	Get a status message from the host (sends an "are you there" query).

⊗X	Change the command escape to the next typed-in character.  This is
	only meaningful in transparent mode.
DATAMEDIA SIMULATION

     A special version of TELNET, called DTN, uses a Datamedia
simulator instead of the page printer.  DTN only runs on displays,
naturally.  Additionally, Datamedia users are probably better off
using TELNET in transparent mode, since besides the grossness of
simulating a Datamedia ON a Datamedia, it is also rather gross to
use since the simulator's keyboard control has been oriented around
the TV keyboards.

     DTN is invoked by the DTN monitor command, and it takes the
same format of commands as TN.  When the connection is completed,
the screen clears, and you are on a simulated Datamedia with a 38
line by 84 character screen.  The CONTROL key maps to ASCII CTRL,
and the META key maps to the Datamedia EDIT key.  NULL is sent the
way you in ASCII, ie, CTRL-@.

     Commands are entered in as follows: to do a "META" command you
use αβFORM followed by the command letter; ie, αβFORM Q gets you out
of TELNET.  To do a "CONTROL-META" command use αβVT followed by the
command letter; ie, αβVT D closes an input file.